docs/development/[Deprecated] Building in Windows light.md

   1 # Building in windows light [Deprecated]
   2
   3 > **Building with this method is deprecated and not advised. All Windows users should be using
   4 Linux Subsystem (WSL) instead**
   5
   6 no cygwin and no path changes
   7
   8 ## Install Git for windows
   9 download https://github.com/git-for-windows/git/releases/download/v2.10.1.windows.1/Git-2.10.1-32-bit.exe
  10
  11 Recommended install location is C:\Git (no spaces or special characters in path)
  12
  13 Follow images as not all are at default settings.
  14
  15 ![Git Installation](assets/001.gitwin.png)
  16
  17 ![Git Installation](assets/002.gitwin.png)
  18
  19 ![Git Installation](assets/003.gitwin.png)
  20
  21 ![Git Installation](assets/004.gitwin.png)
  22
  23 ![Git Installation](assets/005.gitwin.png)
  24
  25 ![Git Installation](assets/006.gitwin.png)
  26
  27 ![Git Installation](assets/007.gitwin.png)
  28
  29 ![Git Installation](assets/008.gitwin.png)
  30
  31 ![Git Installation](assets/009.gitwin.png)
  32
  33 ![Git Installation](assets/010.gitwin.png)
  34
  35 ## Install toolset scripts
  36 download https://www.dropbox.com/s/hhlr16h657y4l5u/devtools.zip?dl=0
  37
  38 extract it into C:\ it creates devtools folder
  39
  40 ## Install latest arm toolchain
  41 download https://gcc.gnu.org/mirrors.html
  42
  43 extract it into C:\devtools\gcc-arm-none-eabi-... (folder already there)
  44
  45 ## Install Ruby
  46
  47 Install the latest Ruby version using [Ruby Installer](https://rubyinstaller.org).
  48
  49 ## Test
  50 Run C:\devtools\shF4.cmd
  51
  52 If everything went according the manual you should be in mingw console window. (if not we need to update this manual)
  53
  54 Try command "arm-none-eabi-gcc --version" and output should be like in screenshot. (tab complete works here)
  55
  56 ![Test toolchain](assets/001.test.png)
  57
  58 Note1: Advanced users can edit shF4.cmd for paths if they don't want to use defaults. You might want to change TOOLS_DIR and PATH_DIRS variables.
  59
  60 Note2: You can copy shF4.cmd anywhere you want and run it from there. It will open console window in that folder.
  61
  62 Note3: Included example batch-scripts (make_REVO.bat) that you can use to build target just by double clicking it.
  63
  64 ## Checkout and compile INAV
  65
  66 Head over to the INAV Github page and grab the URL of the GIT Repository: "https://github.com/iNavFlight/inav"
  67
  68 Run shF4.cmd and use the git commandline to checkout the repository:
  69
  70 ```bash
  71 git clone https://github.com/iNavFlight/inav
  72 ```
  73 ![GIT Checkout](assets/011.git_checkout.png)
  74
  75 ![GIT Checkout](assets/002.test.png)
  76
  77 To compile your INAV binaries, enter the INAV directory and build the project using the make command. You can append TARGET=[HARDWARE] if you want to build anything other than the default SPRACINGF3 target:
  78
  79 ```bash
  80 cd inav
  81 make TARGET=SPRACINGF3
  82 ```
  83
  84 ![GIT Checkout](assets/003.test.png)
  85
  86 within few moments you should have your binary ready:
  87
  88 ```bash
  89 (...)
  90 arm-none-eabi-size ./obj/main/inav_SPRACINGF3.elf
  91    text    data     bss     dec     hex filename
  92  127468     916   16932  145316   237a4 ./obj/main/inav_SPRACINGF3.elf
  93 arm-none-eabi-objcopy -O ihex --set-start 0x8000000 obj/main/inav_SPRACINGF3.elf obj/inav_1.2.1_SPRACINGF3.hex
  94 ```
  95
  96 You can use the INAV-Configurator to flash the ```obj/inav_1.2.1_SPRACINGF3.hex``` file.
  97
  98 ## Updating and rebuilding
  99
 100 Navigate to the local inavflight repository and use the following steps to pull the latest changes and rebuild your version of inavflight:
 101
 102 ```bash
 103 cd inav
 104 git reset --hard
 105 git pull
 106 make clean TARGET=SPRACINGF3
 107 make
 108 ```